home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / setgroups.man < prev    next >
Encoding:
Text File  |  1989-05-30  |  1.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. SETGROUPS             C Library Procedures              SETGROUPS
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      setgroups - set group access list
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ##iinncclluuddee <<ssyyss//ppaarraamm..hh>>
  13.  
  14.      sseettggrroouuppss((nnggrroouuppss,, ggiiddsseett))
  15.      iinntt nnggrroouuppss,, **ggiiddsseett;;
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      _S_e_t_g_r_o_u_p_s sets the group access list of the current user
  19.      process according to the array _g_i_d_s_e_t.  The parameter
  20.      _n_g_r_o_u_p_s indicates the number of entries in the array and
  21.      must be no more than NGROUPS, as defined in <_s_y_s/_p_a_r_a_m._h>.
  22.  
  23.      Only the super-user may set new groups.
  24.  
  25. RREETTUURRNN VVAALLUUEE
  26.      A 0 value is returned on success, -1 on error, with a error
  27.      code stored in _e_r_r_n_o.
  28.  
  29. EERRRROORRSS
  30.      The _s_e_t_g_r_o_u_p_s call will fail if:
  31.  
  32.      [EPERM]        The caller is not the super-user.
  33.  
  34.      [EFAULT]       The address specified for _g_i_d_s_e_t is outside
  35.                     the process address space.
  36.  
  37. SSEEEE AALLSSOO
  38.      getgroups(2), initgroups(3)
  39.  
  40. BBUUGGSS
  41.      The _g_i_d_s_e_t array should be of type ggiidd__tt, but remains
  42.      integer for compatibility with earlier systems.
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0              April 10, 1987                         1
  64.  
  65.  
  66.  
  67.